home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 7 / pcbl203.zip / PCBLIST2.DOC < prev    next >
Text File  |  1990-05-05  |  9KB  |  217 lines
  1.  
  2. Page 1     PCBLIST2.DOC
  3.  
  4.  
  5.                                    PCBList2
  6.                       PCBoard Directory Compilation Program
  7.                                 by MidWest BBS
  8.  
  9.  
  10.  
  11.                                     PROLOGUE
  12.  
  13. A couple of years ago I wrote a very popular program which gathered
  14. specified PCBoard DIR files and created two lists, one sorted by date
  15. and one alphabetical, of all the files.  Many Sysops around the country
  16. use it in their event every day to create the lists for downloading.
  17. Frankly, if you don't need the multi-line features of the new program
  18. there is little reason to change.
  19.  
  20. This new revision is the direct result of the implementation of multi-line
  21. file descriptions implemented in PCBoard 14.0.  Originally,  I personally
  22. didn't care for them, but as time has passed I have begun to appreciate
  23. the utility they bring (if not overdone!).  As I recoded the program, I
  24. tweaked it here and there and made it smarter in locating files etc.
  25. Also, it's a lot prettier (WHO CARES!).  Frankly, the logic to recognize
  26. and anticipate the variations for multiple line descriptions was a bigger
  27. job than I expected.  Hopefully, most variations will be accomodated -
  28. only time will tell.
  29.  
  30.  
  31.                                    LICENSE
  32.  
  33. You are free to do anything you please with this program - use it, sell it
  34. (good luck), ignore it or line the bird cage.  Just remember, I'm no
  35. programmer, Samuel Smith is a programmer.  So, use it at your own risk.
  36. I've tried to make the screens as informative as possible as to what is
  37. going on and will further explain it in the documentation.  If you can use
  38. it, feel free to do so.
  39.  
  40.  
  41.                                    SET UP
  42.  
  43. I hate configuration files!  My disk is littered with cfg, cnf, dat etc.
  44. Well, here's one more.  There was no way that I could maintain the
  45. flexibility that I felt was necessary and avoid it.  Possibly the answer
  46. lies in a self-modifying program like QEDit, but even that approach has
  47. its drawbacks.  Directly reading the PCBoard.Dat and CNames files totally
  48. destroys the flexibility I wanted.  Enough explanation.
  49.  
  50. Incidentally, for those running the original PCBList, there is no change
  51. in the format and structure of the configuration file.  Just use it the
  52. way it is (You're welcome).
  53.  
  54. When PCBList2 starts, it looks for the configuration file used on the
  55. command line.  If there is none, it will search for a file named
  56. PCBList.Ctl.  The command line option is really there to allow multiple
  57. configurations for specialized lists (by conference, topic etc).  The
  58. configuration file looks like this:
  59.  
  60.  
  61. Page 2     PCBLIST2.DOC
  62.  
  63.  
  64. MidWest BBS - Illinois' Professional Bulletin Board
  65. 24 Hours per Day    300/1200/2400/9600(HST) Baud
  66. (708) 513-1034
  67. E:midwest.lst
  68. E:midsort.lst
  69. 10
  70. c:\pcb\gen\dir1
  71. c:\pcb\gen\dir2
  72. c:\pcb\gen\dir3
  73. c:\pcb\gen\dir4
  74. c:\pcb\gen\dir5
  75. c:\pcb\gen\dir6
  76. c:\pcb\gen\dir7
  77. c:\pcb\gen\dir8
  78. c:\pcb\gen\dir9
  79. c:\pcb\gen\dir10
  80.  
  81. The first three lines are any B.S. you want to put at the top of the
  82. listing.  Each line is limited to 78 characters and will be centered when
  83. the program is run.
  84.  
  85. Line 4 is the name (including path if you wish) of the list which will be
  86. sorted alphabetically.  Enter "NONE" (no quotes) if you do not wish to
  87. create the Alpha listing.
  88.  
  89. Line 5 is the name of the list sorted by date.  Enter "NONE" (no quotes)
  90. if you do not wish to create the Date listing.
  91.  
  92. Line 6 is the total number of directories to be scanned.  This is limited
  93. to 200.  This is a, somewhat, arbitrary limitation and if anyone needs more
  94. capacity let me know.
  95.  
  96. Line 7 begins the DIRs to scan - one per line.
  97.  
  98.  
  99.                               RUNNING PCBLIST2
  100.  
  101. Since the whole program was designed to be run in the event, there is
  102. really nothing left to do except sit back and watch.  Most errors will be
  103. trapped and shown on the screen.  Let me know if there are any problems.
  104. The output file looks like this:
  105.  
  106.               MidWest BBS - Illinois' Professional Bulletin Board              
  107.                24 Hours per Day    300/1200/2400/9600(HST) Baud                
  108.                                 (708) 513-1034
  109.           There are 7,553 files totalling 294,069,244 bytes available          
  110.  
  111.          This list prepared on Tuesday, January 31, 1989 at 5:05 A.M.
  112.  
  113. ============   ======  ========  =============================================
  114. Name           Size    Date      Description
  115. ============   ======  ========  =============================================
  116.  
  117. By the way, I haven't got 7,553 files on the BBS.  This is just the output
  118. from one of the tests I made.  The technical limit on the number of files
  119. is over 30,000, but at about 12,000 files there is substantial degradation
  120.  
  121. Page 3     PCBLIST2.DOC
  122.  
  123.  
  124.  
  125.  
  126.                              HOW IT WORKS
  127.  
  128. When PCBList2 is first started it searches for the configuration file in
  129. the current directory, then in the directory where PCBList.Exe resides, if
  130. different (under DOS 3.0 and greater) and then through the defined Path.
  131. If the file is not found by this time, it gives up and quietly dies after
  132. letting you know what happened.  The only error that isn't trapped, as
  133. far as I know, is if the stated configuration file is a binary file or
  134. directory, it will barf and terminate with a runtime error.
  135.  
  136. File descriptions are accumulated in two files, "MWNEW.189" and "SEC.189",
  137. The first file is for all of the primary descriptions and will be
  138. approximately 40% larger than the total of the DIRs being scanned.  The
  139. other file contains the secondary file descriptions.  Both files are erased
  140. when the program terminates, but please make sure that you have sufficient
  141. disk space for them in the current directory (or ram disk if you wish).
  142. PCBList2 will search for the DIR files in the same manner it looks for the
  143. configuration files.  Everything is stripped from the DIRs with the
  144. exception of primary and secondary descriptions, e.g. headers etc.
  145.  
  146. The sorting is done using Borland's Turbo Sort routine.  After using other
  147. methods, I came back to this for one primary reason - virtual memory.
  148. This effectively eliminates memory constraints from the sorting process.
  149. Unless you have a huge number of files or very limited memory, it will
  150. probably never be necessary for a "spill file" to be created, especially
  151. since the portion of the description being passed to the sort is much more
  152. efficient than the prior versions, but the capability is there.
  153.  
  154.  
  155.                              COME ON DOWN
  156.  
  157. Sysops are always welcome at MidWest BBS.  Just leave me a note and let me
  158. know who you are and your access will be upgraded.  A word of warning - I
  159. travel a good bit the early part of the year, so it might be several
  160. days before the increased access is entered.  PCBList2 is available to
  161. everyone though.  While you're on MidWest, please check out DOOR #7,
  162. Chuck-A-Luck.  It's under construction and I would appreciate any
  163. comments, suggestions etc. - it only takes a couple of minutes to play.
  164.  
  165. Steve Mills, SYSOP
  166.  
  167.  
  168. Last Minute Addition : DRAT! Somewhere around here I must have a simple
  169. program to format ASCII files for a printer, but where!  Anyway, if anyone
  170. else needs it, there is a file in the archive called FORPRINT.EXE.  Just
  171. enter the name of the file you want formatted and the name of the output
  172. file to be created on the command line.  Page length is set at 59, so
  173. those lucky soles with laser printers can get usable output.  Run FORPRINT
  174. without anything on the command line for instructions.  The same license
  175. applies to FORPRINT as stated for PCBList2.
  176.  
  177.  
  178.  
  179. Page 4     PCBLIST2.DOC
  180.  
  181.  
  182. Acknowledgements:
  183.  
  184. PCBoard is Copyright of Clark Development Co.
  185.  
  186.  
  187. The Technical Crap:
  188.  
  189. For those that are interested, Units from Turbo Power's "Turbo
  190. Professional" and Bob Ainsbury's "Technojock's Turbo Toolkit" were
  191. used, as well as the sort routine from Borland's Database Toolbox.
  192. Both TPro and TTT have recently been upgraded and I highly recommend the
  193. purchase of either or both if you do much programming in Turbo Pascal.
  194. After trying a number of Turbo Pascal tools, there is little doubt in my
  195. mind that these offer the best functionality, documentation and bang
  196. for the buck.
  197.  
  198. Also, I can't imagine anyone writing a PCBoard utility without, in some
  199. fashion, relying on the incredible work of Sam Smith.  His concise, well
  200. documented code is indispensible when working with PCBoard files (and many
  201. other things for that matter).  Thanks Sam!
  202.  
  203. Revision History:
  204.  
  205. 2.01  Minor cosmetic changes and speed enhancements.
  206.  
  207. 2.02  Well it happened - Someone (Philip Stults) needed more than 50
  208.       DIRS, so it now accomodates 200.  This should be sufficient for a
  209.       while.
  210.  
  211. 2.03  Some Sysops only wished to create the Alpha or Date listings.  By
  212.       entering "NONE" on the proper line of the configuration file this
  213.       can now be accomplished.  Also, some minor internal changes.
  214.  
  215.  
  216.  
  217.